<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!-- Copyright 1997 The Open Group, All Rights Reserved -->

<title>meta</title>
</head><body bgcolor=white>
<center>
<font size=2>
The Single UNIX &reg; Specification, Version 2<br>
Copyright &copy; 1997 The Open Group

</font></center><hr size=2 noshade>
<h4><a name = "tag_001_009_071">&nbsp;</a>NAME</h4><blockquote>
meta - enable/disable meta-keys
</blockquote><h4><a name = "tag_001_009_072">&nbsp;</a>SYNOPSIS</h4><blockquote>
<pre><code>

#include &lt;<a href="curses.h.html">curses.h</a>&gt;

int meta(WINDOW *<i>win</i>, bool <i>bf</i>);
</code>
</pre>
</blockquote><h4><a name = "tag_001_009_073">&nbsp;</a>DESCRIPTION</h4><blockquote>
Initially, whether the terminal returns 7 or 8 significant bits on input
depends on the control mode of the display driver (see the <b>XBD</b> specification,
<b>General Terminal Interface</b>).
To force 8 bits to be returned, invoke <i>meta</i>(<i>win</i>, TRUE).
To force 7 bits to be returned, invoke <i>meta</i>(<i>win</i>, FALSE).
The <i>win</i> argument is always ignored.  If the <b>terminfo</b> capabilities
<b>smm</b> (meta_on) and <b>rmm</b> (meta_off) are  defined for the terminal,
<b>smm</b> is sent to the terminal when <i>meta</i>(<i>win</i>, TRUE) is called
and <b>rmm</b> is sent when <i>meta</i>(<i>win</i>, FALSE) is called.
</blockquote><h4><a name = "tag_001_009_074">&nbsp;</a>RETURN VALUE</h4><blockquote>
Upon successful completion,
<i>meta()</i>
returns OK.  Otherwise, it returns ERR.
</blockquote><h4><a name = "tag_001_009_075">&nbsp;</a>ERRORS</h4><blockquote>
No errors are defined.
</blockquote><h4><a name = "tag_001_009_076">&nbsp;</a>APPLICATION USAGE</h4><blockquote>
The same effect is achieved outside Curses using the CS7 or CS8 control mode
flag specified in the <b>XBD</b> specification (<b>General Terminal Interface</b>).
<p>
The
<i>meta()</i>
function was designed for use with terminals with 7-bit character sets and
a &quot;meta&quot; key that could be used to set the eighth bit.
</blockquote><h4><a name = "tag_001_009_077">&nbsp;</a>SEE ALSO</h4><blockquote>
<xref href=terminalinput><a href="intov.html#tag_001_005">
Input Processing
</a></xref>,
<i><a href="getch.html">getch()</a></i>,
<i><a href="curses.h.html">&lt;curses.h&gt;</a></i>,
<b>XBD</b> specification, <a href="../xbd/termios.html#tag_008_002"><b>Parameters that Can be Set</b>&nbsp;</a>  (ISTRIP flag).
</blockquote><hr size=2 noshade>
<center><font size=2>
UNIX &reg; is a registered Trademark of The Open Group.<br>
Copyright &copy; 1997 The Open Group
<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]

</font></center><hr size=2 noshade>
</body></html>
